2. Uppsala TXID 스크리닝

블록체인 거래 ID(해시)를 제공함으로써, 이 API는 해당 txid와 관련된 지갑 주소들과 연관된 위험을 탐지합니다.

TXID에 대한 위험 탐지 결과는 "BLACK/GRAY/WHITE/UNKNOWN"으로 제공되며, 탐지 결과가 "BLACK" 및 "GRAY"에 해당하는 경우 범죄 피해 유형에 대한 추가 정보가 제공됩니다.

Uppsala Wallet Screening API는 개발 환경을 지원하지 않습니다. 운영 환경을 사용하십시오.

참고: 이 API는 CodeVASP와 Uppsala Security가 공동으로 운영합니다. 문의사항이나 액세스 요청은 partnership@codevasp.com으로 연락하십시오.

Endpoint

POST /v1/code/uppsala/tx-hash

요청 매개변수

Body 매개변수

이름	유형	필수 여부	설명
txid	string	필수	블록체인 거래 ID입니다.
chain	string	필수	디지털 자산에 대한 심볼입니다 (예: "ETH"). 지원 대상: BTC, ETH, SOL, LTC, TRX, EOS, XLM, ADA, BNB, BCH, XRP, BSC, KLAY, DASH, DOGE, ZEC, FTM, MATIC, AVAX.

응답

필드

이름	유형	설명
result	string	결과 (NORMAL, ERROR)입니다.
id	string	트래픽 ID입니다.
senderWallets	array	송신자 지갑 정보 목록입니다.
receiverWallets	array	수신자 지갑 정보 목록입니다.
reasonMsg	string	오류 발생 시 상세 메시지입니다.

WalletInfo 객체:

• walletAddress: 지갑 주소입니다.
• securityCategory: 위험 수준입니다 (BLACK, GRAY, WHITE, UNKNOWN).
• securityTags: 태그 목록입니다.
• detailedDescription: 설명입니다.

예제

요청

curl --request POST \
     --url https://trapi-dev.codevasp.com/v1/code/uppsala/tx-hash \
     --header 'X-Code-Req-Datetime: datetime' \
     --header 'X-Code-Req-Nonce: nonce' \
     --header 'X-Code-Req-PubKey: Your key' \
     --header 'X-Code-Req-Signature: Sig' \
     --header 'X-Request-Origin: code:yourVaspEntityId' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "txid": "0x655dd40d5919d01d7d6a84c8d0fb125552bd3be23eee0750f440d98783908344",
  "chain": "eth"
}
'

응답

{
  "id": "test5-0327042656-7ed4fd5a",
  "senderWallets": [
    {
      "walletAddress": "0x098b716b8aaf21512996dc57eb0615e2383e2f96",
      "securityCategory": "BLACK",
      "securityTags": [
        "Exploits",
        "Lazarus",
        "OFAC Sanctions"
      ],
      "detailedDescription": "Main wallet of Ronin Bridge Exploiter"
    }
  ],
  "receiverWallets": [
    {
      "walletAddress": "0x665660f65e94454a64b96693a67a41d440155617",
      "securityCategory": "BLACK",
      "securityTags": [
        "Exploits",
        "Lazarus"
      ],
      "detailedDescription": "Exploiter's intermediary wallet. Exploiter sends USDC here before swapping on Uniswap"
    }
  ],
  "result": "NORMAL",
  "statusCode": 200
}